package com.school.sports.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.school.sports.dto.ProjectDTO;
import com.school.sports.entity.Project;

import java.util.List;

/**
 * 运动项目服务接口
 */
public interface ProjectService extends IService<Project> {

    /**
     * 根据ID查询项目详情（包含创建人信息）
     * @param id 项目ID
     * @return 项目详情
     */
    Project getProjectWithCreator(Long id);

    /**
     * 更新项目状态
     * @param id 项目ID
     * @param status 新状态
     * @return 更新结果
     */
    boolean updateProjectStatus(Long id, String status);

    /**
     * 校验项目名称是否已存在
     * @param name 项目名称
     * @return 存在返回true
     */
    boolean existsByName(String name);

    /**
     * 分页查询项目列表
     * @param page 分页对象
     * @param queryWrapper 查询条件
     * @return 分页结果
     */
    IPage<Project> page(Page<Project> page, com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<Project> queryWrapper);

    /**
     * 根据项目类型查询项目列表
     * @param type 项目类型
     * @return 项目列表
     */
    List<Project> getProjectsByType(String type);

    /**
     * 根据项目状态查询项目列表
     * @param status 项目状态
     * @return 项目列表
     */
    List<Project> getProjectsByStatus(String status);

    /**
     * 获取所有项目类型
     * @return 项目类型列表
     */
    List<String> getAllProjectTypes();

    /**
     * 获取所有项目状态
     * @return 项目状态列表
     */
    List<String> getAllProjectStatuses();

    /**
     * 获取所有性别限制选项
     * @return 性别限制列表
     */
    List<String> getAllGenderLimits();

    /**
     * 批量更新项目状态
     * @param projectIds 项目ID列表
     * @param status 新状态
     * @return 更新结果
     */
    boolean batchUpdateStatus(List<Long> projectIds, String status);

    /**
     * 统计项目总数
     * @return 项目总数
     */
    long countProjects();

    /**
     * 根据状态统计项目数量
     * @param status 项目状态
     * @return 项目数量
     */
    long countProjectsByStatus(String status);

    /**
     * 获取热门项目（按报名人数排序）
     * @param limit 限制数量
     * @return 项目列表
     */
    List<Project> getPopularProjects(Integer limit);

    /**
     * 分页查询项目信息（包含创建者和统计信息）
     * 使用优化的JOIN查询避免N+1问题
     *
     * @param page 分页参数
     * @param name 项目名称（可选）
     * @param type 项目类型（可选）
     * @param status 项目状态（可选）
     * @param genderLimit 性别限制（可选）
     * @return 分页结果
     */
    IPage<ProjectDTO> getProjectPageWithDetails(
            Page<ProjectDTO> page,
            String name,
            String type,
            String status,
            String genderLimit
    );

    /**
     * 根据项目ID查询项目详细信息（包含创建者和报名统计）
     *
     * @param projectId 项目ID
     * @return 项目详细信息
     */
    ProjectDTO getProjectDetailsById(Long projectId);

    /**
     * 根据项目名称模糊查询项目列表（包含详细信息）
     * 使用优化的索引查询
     *
     * @param name 项目名称
     * @return 项目列表
     */
    List<ProjectDTO> searchProjectsByName(String name);

    /**
     * 查询可以报名的项目列表
     *
     * @return 可报名项目列表
     */
    List<ProjectDTO> getAvailableProjects();
}